home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / seyon / 1-FAQ < prev    next >
Text File  |  1995-05-03  |  21KB  |  618 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.           F R E Q U E N T L Y   A X E D   Q U E S T I O N S
  4.  
  5. -----------------------------------------------------------------------------
  6.  
  7.     Thanks to Johann Miranda (miranda@suspicion.eng.uiowa.edu) for his
  8.     help in maintainig this FAQ.
  9.  
  10. -----------------------------------------------------------------------------
  11.  
  12.     Warning: Some of the things below are terribly outdated. Tha
  13.     manual page, though, is always up-to-date.
  14.  
  15. -----------------------------------------------------------------------------
  16.  
  17. Q: How can I obtain Seyon?
  18.  
  19. A: Well, the best way is to ftp to one of the following sites:
  20.  
  21.          sipb.mit.edu:/pub/seyon
  22.          export.lcs.mit.edu:/contrib
  23.          nic.funet.fi
  24.          sunsite.unc.edu
  25.  
  26.    The *newes* version of Seyon can be found at sipb.mit.edu. Beta
  27.    versions can also found at: 
  28.  
  29.          sipb.mit.edu:/pub/seyon
  30.  
  31.    and context diffs against previous versions at:
  32.  
  33.          sipb.mit.edu:/pub/seyon/DIFFS
  34.  
  35.    You may have to hunt around in other sites to find the most recent
  36.    release.
  37.  
  38. -----------------------------------------------------------------------------
  39.  
  40. Q: How do I build and install Seyon?
  41.  
  42. A: Seyon comes with a file called 1-INSTALL, which basically tells you
  43.    what you need to do to install it. You should also create a
  44.    directory with the name ".seyon" in your home directory. Copy the
  45.    files ``startup'', ``phonelist'' and ``startup'' to this directory
  46.    (the make file will probably do that automatically for you) and
  47.    edit them to your heart's content; or better yet, run Seyon and
  48.    modify these these files from the command center. Once you have
  49.    installed Seyon, you may wish to browse through the man page, it is
  50.    complete and up-to-date.
  51.  
  52. -----------------------------------------------------------------------------
  53.  
  54. Q: How do I use Seyon?
  55.  
  56.    This is easy. After installation, just type "seyon -modems
  57.    <modem-device> &" to invoke Seyon. From the command center you can
  58.    set up your modem parameters, line parameters, scripts, phone
  59.    numbers, transfer protocols, to wit anything you are likely to
  60.    need.  Afterwards, customaize Seyon to your needs by putting the
  61.    appropriate resources in your ~/.Xresources or ~/.Xdefaults file
  62.    (at least to avoid typing the -modems switch every time).
  63.  
  64. -----------------------------------------------------------------------------
  65.  
  66. Q: Where can I send bug reports and suggestions? Where can I get more
  67.    information about the development and use of Seyon? Where can I
  68.    participate in general discussions about Seyon? Where can I get the
  69.    most up-to-date announcements about official and test releases?
  70.  
  71. A: Join the Seyon mailing list. Send a message to
  72.  
  73.             linux-activists-request@joker.hut.fi
  74.  
  75.    with the following as one of the headers:
  76.  
  77.             X-Mn-Admin: join Seyon
  78.  
  79.    That should do it. To get more information about how to use the
  80.    mailing list and send to it, send a message to the above address
  81.    with the single word ``help'' as the subject and the body of the
  82.    message.
  83.  
  84. -----------------------------------------------------------------------------
  85.  
  86. Q: Yesterday I compiled Seyon 2.12, however when I tried to run it,
  87.    it gave me "Dial Arborted: Online". So I hangup first, the message
  88.    now is "Line disconnected", then I dialed again, still "online".
  89.    I quit and run kermit immediately and it works fine. This 'Online'
  90.    problem happens even I hard-boot my system and run seyon at once.
  91.    Has anybody have the same experience ? Any help will be appreciated.
  92.  
  93. A: Seyon is smarter that kermit (well, at least it tries to). Before
  94.    dialing a number, Seyon first checks to see if the modem is already
  95.    on-line. It does so by querying the status of the DCD flag (Data
  96.    Carrier Detect). If DCD is asserted, Seyon concludes that the modem is
  97.    on-line and refuses to dial the number.
  98.  
  99.    Two resources govern this behavior. The first is hangupBeforeDial. If
  100.    this resource is enabled (set to ``on'') and DCD is asserted, Seyon
  101.    hangs up the line before dialing. The second is ignoreModemDCD. If
  102.    this resource is enabled, Seyon ignores the status of DCD and 1)
  103.    always hangs up befoe dialing if hangupBeforeDial is enabled, and 2)
  104.    proceeds to dial even if DCD is asserted.
  105.  
  106.    In your case I think that your modem is asserting DCD all the time,
  107.    even if the modem is off-line. When dialing, Seyon finds that DCD is
  108.    asserted and hangs up. However, after hanging up, it finds that DCD is
  109.    still asserted, and since the default for ignoreModemDCD is ``off'',
  110.    it refuses to dial.
  111.  
  112.    To fix that, you have two options. The first is to tell your modem not
  113.    to assert DCD all the time. The command for that in my modem is
  114.    ``AT&C1'' (AT&C0 does the opposite), but might be different in yours.
  115.    If you don't wish to do that, set the resource ignoreModemDCD to
  116.    ``on''. This way Seyon will ignore DCD and behave just like kermit. To
  117.    set the resource, put the line:
  118.  
  119.              Seyon.ignoreModemDCD: on
  120.  
  121.    in your ~/.Xresource file.
  122.  
  123.    The on-line clock at the top left corner of Seyon's command center
  124.    will tell you whether DCD is asserted (clock running, button light or
  125.    depressed) or not (clock not running, button dark or raised). The
  126.    manual has more details and explanations of the above resources.
  127.  
  128. -----------------------------------------------------------------------------
  129.  
  130. Q: I get the messages
  131.  
  132. >> Warning: could not execute 'seyon-emu'.
  133. >> Warning: falling to 'xterm'.
  134.  
  135.    when I start Seyon.
  136.  
  137. A: When Seyon s invoked. It looks first for seyon-emu and uses it as
  138.    the terminal emulator. seyon-emu has to be a link to you favorite
  139.    terminal emulation program (xterm, color xterm, xvt, mterm, Emu,
  140.    cmdtool, ..etc). This allows for more flexibility in choosing the
  141.    terminal emulator. If Seyon doesn't find seyon-emu, it just uses
  142.    xterm as the terminal emulator. This warning is harmless. To get
  143.    rid of it, make seyon-emu a link to xterm.
  144.  
  145. Q: How do I use the meta (ALT) key with Seyon?
  146.  
  147. A: If the remote host supports 8-bit-clean communications, you should
  148.    be able to use it automatically (most hosts don't).  Otherwise, you
  149.    can make Seyon send ESC before a character when the meta key is
  150.    pressed with that character.  You can do that in two ways:
  151.  
  152.    1) Set Meta->ESC translation to ``on'' using one of the following:
  153.       a) the resource metaKeyTranslation 
  154.       b) from the ``Set'' console
  155.       c) in a script: ``set meta_tr on''
  156.  
  157.    2) if you're using xterm as Seyon's terminal emulator, use
  158.  
  159.       Seyon.vt100.eightBitInput: off
  160.  
  161. -----------------------------------------------------------------------------
  162.  
  163. Q: When I dial, the modem says CONNECT and I get a Connection Complete
  164.    message. To wake the remote host up, I first hit Enter a few times.
  165.    But the host soon hangs up, apparently seeing a dead line. What's
  166.    wrong?
  167.  
  168. A: Try setting <nl mode> in the Set console. The Seyon default is to
  169.    send a \n when you press Enter. Many hosts expect a \r; you get
  170.    that when <nl mode> is selected.
  171.  
  172.    (contributed by Sakari Aaltonen, <sakaria@vipunen.hut.fi>)
  173.  
  174.    NOTE: starting from version 1.5, the defaults is to enable NL->CR
  175.    translation.
  176.  
  177. =======================================
  178.  
  179. Q: In the 'Set' console, which color means that the parameter is
  180.    active?
  181.  
  182. A: Black means active, otherwise inactive.
  183.  
  184. =======================================
  185.  
  186. Q: How do I send an initialization string to my modem.
  187.  
  188. A: put the command
  189.  
  190.        transmit "AT(whatever)^M"
  191.  
  192.    in Seyon's startup file. Most modern modems do not need an
  193.    initialization string though, since they store their setup in
  194.    non-volitile memory.
  195.  
  196. =======================================
  197.  
  198. Q: How do I tell the remote host about the size of my terminal window?
  199.    I want the applications to take advantage of the lerger size.
  200.  
  201. A: If the remote host is a Unix machine (or any other machine that
  202.    supports X-windows), issue the command 'resize' (if that doesn't
  203.    help, try 'eval `resize`'. If the remote host is a BBS, set the
  204.    page length by the appropriate command (e.g. 'p' on a BBS running
  205.    PCBoard).
  206.  
  207. =======================================
  208.  
  209. Q: What's this Xdefaults file you keep talking about?
  210.  
  211. A: It is usually named ~/.Xresources. If that doesn't exist. the
  212.    Xserver uses the file ~/.Xdefaults. Do 'man X' to learn how to
  213.    customize the resources in this file.
  214.  
  215. =======================================
  216.  
  217. Q: When I use 'Edit' to edit the phonelist or protocols files, the
  218.    dialing directory and the transfer console do not reflect the
  219.    changes I made, what's wrong?
  220.  
  221. A: You have to use 'Reread' to update the the dialing directory and
  222.    the transfer console.
  223.  
  224. =======================================
  225.  
  226. Q: How do I make sz/rz work?
  227.  
  228. A: The following is from the readme file included with minicom. I used
  229.    it, and it has always worked for me:
  230.  
  231.    If you are using a new version if Chuch Forsenberg's zmodem, it is
  232.    possible that it will not run OK in a window. This is because the
  233.    new versions *don't* use stdin and stdout, but without mercy they
  234.    just open /dev/tty. Ai! I changed the following in the file
  235.    "rbsb.c" and now things work allright. You might want to change
  236.    this also.  Here is the particular function I'm talking about:
  237.  
  238. ---------------------------------------
  239. /* Line 336 */
  240. /* Initialize tty device for serial 
  241.    file xfer */
  242. inittty()
  243. {
  244. #ifndef HVM
  245.     Tty = open("/dev/tty", 2);
  246.     if (Tty < 0) {
  247.        perror("/dev/tty");  exit(2);
  248.     }
  249. #else
  250.     Tty = 1;
  251. #endif
  252.     Ttystream = fdopen(Tty, "w");
  253.     setbuf(Ttystream, xXbuf);        
  254. }
  255. ---------------------------------------
  256.  
  257.    And to get the Logging output to the
  258.    screen instead of to /tmp/szlog,
  259.    change the following in sz.c :
  260.  
  261. ---------------------------------------
  262. if (npats < 1 && !Command && !Test) 
  263.     usage();
  264. if (Verbose) {
  265. /* Line 403 of sz.c */
  266. #ifndef HVM
  267.     if (freopen(LOGFILE, "a", stderr)==NULL) {
  268.         printf("Can't open log file %s\n",LOGFILE);
  269.         exit(2);
  270.     }
  271. #endif
  272.     setbuf(stderr, NULL);
  273. }
  274. vfile("%s %s for %s\n", Progname, VERSION, OS);
  275. ---------------------------------------
  276.  
  277.    You might want to change the same in the file "rz.c" also, around
  278.    line 249.  It is now possible to use the -v[vv] flag with rz/sz and
  279.    see the debugging output appear in the status window!
  280.  
  281.    You have to define 'HVM' to make the change effective, ofcourse!
  282.  
  283.    NOTE (for Seyon users): Once you have done that, use '$rz -vv' as
  284.    your zmodem command (or '$sz -vv').
  285.  
  286. =======================================
  287.  
  288. Q: What are Seyon's configuration files? and where should they be put?
  289.  
  290. A: Those are 'startup', 'phonelist', and 'protocols'. Seyon looks for
  291.    them in the current directory, then the default Seyon directory
  292.    ('~/.seyon'), and finally in the user's home directory. The names
  293.    of these files as well as that of the default directory can be
  294.    overridden by setting the appropriate resources. Refer to that in
  295.    another answer somewhere in this file.
  296.  
  297. =======================================
  298.  
  299. Q: Can I put the scripts somewhere else other than in my home
  300.    directory?
  301.  
  302. A: Yes, use the resource 
  303.  
  304.         Seyon.scriptDirectory:
  305.  
  306.    (default is defaultDirectory). Seyon will look for scripts in the
  307.    current directory, then in the script directory, and finally in the
  308.    user's home directory.
  309.  
  310. =======================================
  311.  
  312. Q: I'd like to start a local shell but I don't want to start another
  313.    xterm, can I have a shell in the Seyon's terminal emulation window?
  314.  
  315. A: Yes, click the 'Shell' button and instead of giving it a usual
  316.    shell command, use the name of your shell (i.e. tcsh, sh, ..etc).
  317.    This will start the shell of your choice in the terminal window.
  318.  
  319. =======================================
  320.  
  321. Q: Do I have to specify the BITS and BPS fileds for each entry in the
  322.    phonelist directory?
  323.  
  324. A: No. Seyon will use the default BPS rate and bit mask if none is
  325.    specified in the phonelist entry.
  326.  
  327. =======================================
  328.  
  329. Q: Can I specify an alternate location and name for the help file?
  330.  
  331. A: You can, but it's highly discouraged unless you have no write
  332.    permission to the default location (determined automatically at
  333.    compile-time). Use the resource
  334.  
  335.             Seyon.helpFile:
  336.  
  337.    You have to specify the complete file path and name.
  338.  
  339. =======================================
  340.  
  341. Q: Seyon comes up tiny and with overlapping buttons, what's wrong?
  342.  
  343. A: The app-defaults file must be installed properly or Seyon will not
  344.    function properly. Use 'make install' to install the app-defaults
  345.    file in the proper place and make sure it is installed properly and
  346.    is not corrupt.
  347.  
  348. =======================================
  349.  
  350. Q: I get 'killed by siganl 11' when I start seyon.
  351.  
  352. A: You must be using old versions of libraraies. Test that by using
  353.  
  354.             ldd seyon-cmd
  355.  
  356.    This will tell you what libraries you have linked Seyon with. If
  357.    you get anything other than
  358.  
  359.       /lib/XawVen.so.2.1 (Classic 2.1)
  360.       /lib/libX11.so.2.1 (Classic 2.1)
  361.       /lib/libc.so.4 (Jump table 4.1)
  362.  
  363.    it's time to upgrade to newer libraries.
  364.  
  365.    (This question is for linux only, for platforms it may be a bug.
  366.    Report it.)
  367.  
  368. =======================================
  369.  
  370. Q: How does the dialer work?
  371.  
  372. A: Click on an item to toggles it. Once you have selected all the
  373.    items you want, click on 'Go'. The dialer will dial each number
  374.    until a connection is made. once a connection is made, that item is
  375.    unselected automatically. Double-clicking on an item will select
  376.    that item, unselect all others, and dial that item. You can
  377.    interrupt the dialing or the script execution at any time by
  378.    chossing 'Cancel'. 'Can. & hangup' will additionally hangup the
  379.    line.
  380.  
  381. -----------------------------------------------------------------------------
  382.  
  383. Q: How do I use pulse dialing?
  384.  
  385. A: Use the resources. Set
  386.  
  387.        Seyon.dialPrefix: ATDP
  388.  
  389.    There is also a simialr resource: dialSuffix.
  390.  
  391. -----------------------------------------------------------------------------
  392.  
  393. Q: How can I setup the ZMODEM autodownload feature or disable it?
  394.  
  395. THIS ANSWER IS WRONG, READ THE MANUAL
  396.  
  397. A: Via the resources. The resource
  398.  
  399.      Seyon.zmodemAutoDownload: off
  400.  
  401.    will disable it (default is 'on'). The resource
  402.  
  403.    Seyon.zmodemAutoDownloadCommand: $cd /usr/dl; rz -vv
  404.  
  405.    tells Seyon what command to use to for ZMODEM (default is 'rz').
  406.    The format of the command is the same as that of the shell and
  407.    transfer commands.
  408.  
  409. -----------------------------------------------------------------------------
  410.  
  411. Q: Does Seyon support the V32 protocol?
  412.  
  413. A: V32 is not a software protocol, it is used at the hardware level by
  414.    the modem to communicate with modems at the remote end. Hence, it
  415.    is transparent to comm programs, and they have nothing to do with
  416.    it.
  417.  
  418.    This is along the lines of "your modem will talk to my modem at the
  419.    best speed and level they can. How yor modem talks to your computer
  420.    is your business" (See above)
  421.  
  422. -----------------------------------------------------------------------------
  423.  
  424. Q: How do I turn off the 'fun' messages or make them less frequent?
  425.  
  426. A: The resource
  427.  
  428.            Seyon.showFunMessages: off
  429.  
  430.    will turn them off (default is 'on'). The resource
  431.  
  432.         Seyon.funMessagesInterval: 30
  433.  
  434.    specifies that the messages should appear every 15 seconds (unless
  435.    Seyon has something more important to say, like a real message).
  436.    Default interval is 1 minute.
  437.  
  438. =======================================
  439.  
  440. Q: How can tell seyon what port to use?
  441.  
  442. A: There are two ways to do that:
  443.  
  444.    1) Specify it in your Xdefaults file, something like:
  445.              
  446.              Seyon.modems: /dev/ttys0
  447.  
  448.    2) Invoke Seyon by the the switch -modems, e.g.
  449.              
  450.              seyon -modems /dev/ttys0
  451.  
  452. =======================================
  453.  
  454. Q: How can I control the bahavior of the terminal emulation winow?
  455.  
  456. A: You can do that via the resources of the vt100 widget of xterm. he
  457.    following is an example of what you can put in your Xdefaults file:
  458.  
  459.      Seyon.vt100.foreground: black
  460.      Seyon.vt100.background: white
  461.      Seyon.vt100.geometry: 80x25+50+250
  462.      Seyon.vt100.saveLines: 100
  463.                         .            
  464.                         .
  465.                         .
  466.  
  467.    Refer to the xterm manual page for the full set of the resources.
  468.  
  469. =======================================
  470.  
  471. Q: The resourecs I put in my Xdefaults file do not seem to work, why?
  472.  
  473. A: You have to use xrdb to load the resourecs or restart your X
  474.    server.  Also, you have to use the class name 'Seyon' and not the
  475.    instance 'seyon' in your Xdefaults file.
  476.  
  477. =======================================
  478.  
  479. Q: How shoud the protocols file be formatted?
  480.  
  481. A: Here is an example:
  482.  
  483.     regu_zm_dl  "$ cd /dl; rz -vv" n
  484.     "reg zm ul" "$sz -vv"          y
  485.     graphic_zm_dl grz              No
  486.     xrz3D       $cd /dl; xrz"      NO
  487.  
  488.    The first field is the title of the protocol. You can anything in
  489.    there for your refrence as long as it is either one word or quoted.
  490.  
  491.    The second field is the actual command that will be executed.
  492.    Again,if the command is more than one word, it has to be quoted.
  493.    Notice how 'cd' is used to have one or more download or upload
  494.    directories. If the command begins with '$', the standard input and
  495.    standard outpt will be redirected to the modem.
  496.  
  497.    The last field tells Seyon whether it should prompt for a file name
  498.    or not. this field can be either a yes or a no. Normally, you would
  499.    put yes for an upload and no otherwise.
  500.  
  501. =======================================
  502.  
  503. Q: How can tell Seyon about the non-standard responses of my modem?
  504.  
  505. A: Use the following resources:
  506.  
  507.        Seyon.connectString
  508.        Seyon.noConnectString1
  509.        Seyon.noConnectString2
  510.        Seyon.noConnectString3
  511.        Seyon.noConnectString4
  512.  
  513.    Refer to what the defaults are for these resources in another
  514.    answer in this file.
  515.        
  516. =======================================
  517.  
  518. Q: When I choose an item in the dialing direcory or from the transfer
  519.    protocols directory it get highlighted but nothing happens, why?
  520.  
  521. A: Clicking once on an item only highlightes it. You have to
  522.    double-click on it to choose it. You can highlight multiple items
  523.    in the dialing directory and then click 'Go' to dial them
  524.    (circulate) until a connection is made.
  525.  
  526. =======================================
  527.  
  528. Q: How can I control the dialer behavior?
  529.  
  530. A: Via the following resources:
  531.  
  532.        Seyon.dialTimeOut
  533.        Seyon.dialDelay
  534.        Seyon.dialRepeat
  535.  
  536.    Dial timeout is the time given for each try (default is 45
  537.    seconds), dial delay is the time between tries (default is 10
  538.    seconds), and dial repeat is the number of tries Seyon attempts
  539.    before up (default is 5 seconss).
  540.  
  541. =======================================
  542.  
  543. Q: How can disable the confirmation popups for hangup and exit?
  544.  
  545. A: Via the resources hangupConfirm and exitConfirm. Put the following
  546.    in your Xdefaults file:
  547.  
  548.            Seyon.hangupConfirm: off
  549.            Seyon.exitConfirm: off
  550.  
  551. =======================================
  552.  
  553. Q: What do I do if the terminal is stuck?
  554.  
  555. A: Choose 'Refresh' under the 'Misc' button. This will restart the
  556.    terminal process (not the terminal window).
  557.  
  558. =======================================
  559.  
  560. Q: How can I use hardware flow control (RTS/CTS)?
  561.  
  562. A: Use the rtscts mode. It is enabled by default. You disable it in
  563.    the startup file, in a script, or interactively from the 'Set'
  564.    console.
  565.  
  566. =======================================
  567.  
  568. Q: How can I make Seyon send delete instead of backspace?
  569.  
  570. A: Put the line
  571.  
  572.        set del "on"
  573.  
  574.    in the startup file or in the script. or set the parameter
  575.    interactively by the 'Set' button.
  576.  
  577. =======================================
  578.  
  579. Q: Can Seyon do ANSI color that most BBS systems use?
  580.  
  581. A: Yes, but yu have to get color xterm.  Patches for that are on
  582.    export.lcs.mit.edu.
  583.  
  584. =======================================
  585.  
  586. Q: Where can I get the latest copy of Seyon?
  587.  
  588. A: By ftp from sipb.mit.edu at the directory /pub/seyon.
  589.  
  590. =======================================
  591.  
  592. Q: How can I help?
  593.  
  594. A: 1) Send your impression of he program after each upgrade.
  595.    2) Send suggestions for improvement (even the little details).
  596.    3) Send any pretty color customization you do.
  597.    4) If you implement an extra feature, send it to be included in the
  598.       standard release.
  599.  
  600. =======================================
  601.  
  602. Q: How can I send bug reports?
  603.  
  604. A: Use the form included in the file BUGS. If you don't, I cannot
  605.    guarantee that I'm going to look into it. Sending me something like
  606.    'the dialer doesn't work' doesn't tell anything. I have to know
  607.    more.
  608.  
  609. =======================================
  610.  
  611. Q: How can I contact the author?
  612.  
  613. A: Send him (that's me!) email at alsaggaf@mit.edu
  614.  
  615. =======================================
  616.  
  617.                                    
  618.